home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 2: CDPD 1
/
Almathera Ten on Ten - Disc 2: CDPD 1.iso
/
pd
/
201-225
/
204
/
jpclock
/
jpclock.doc
< prev
next >
Wrap
Text File
|
1995-03-13
|
7KB
|
130 lines
*****************************************************************************
JPClock
© Copyright 1989 by Jonathan Potter
Another fantabulous Public Domain release
*****************************************************************************
JPClock - the ultimate WorkBench clock!
USAGE :
JPClock [FLAGS]
Flags are:
-a : Set Alarm on
-atALARMTIME : Set Alarm time to ALARMTIME (HH:MM:SS or H:MM:SSC)
-dSECONDS : Set Delay between updates to SECONDS seconds
-f : Set Stay Front on
-ot : Turn time display off
-oy : Turn day display off
-od : Turn date display off
-of : Turn fast memory display off
-oc : Turn chip memory display off
-ol : Turn total memory display off
-s : Swap to second screen
-u : USA format; MM-DD-YY instead of DD-MM-YY
-xX : Open window with x-coordinate X
-yY : Open window with y-coordinate Y
-12 : Set time to 12 hours format
Since the Amiga's conception, there have been umpteen different clock
programs to go with it. The first of these, of course, was the WorkBench
Clock, and other (third-party?) clocks have followed suit. Each one offered
slightly different features; all (of course) showed time, some showed free
memory in the system, and some showed the date. However, I have never found
a clock program that is quite flexible enough, with enough features for me.
Enter JPClock!
JPClock is quite a short clock program, around 13K long, however it is
packed with features. On first appearance, it looks just like any other
clock, with maybe a little more. A title bar-height window opens at the
top of the WorkBench screen, displaying the following information
TIME DAY DATE FAST CHIP TOTAL
in the following format
HH:MM:SS DDD DD-MM-YY XXXX XXXX XXXX
(note, as yet I have not found another clock program that gives all this
information.) Quite simply, TIME is the current time, DAY is the day of the
week, and DATE is the date. Note that by specifying the -u flag when running
JPClock, DATE is displayed in the USA format of MM-DD-YY. FAST is the amount
of free FAST memory in the system, likewise CHIP is the amount of free CHIP
memory in the system, and TOTAL is the two added together.
Activating the JPClock window (which can be closed, dragged and depth
arranged) by clicking on it, and then pressing the RIGHT MOUSE BUTTON,
POPs open a larger window with several gadgets in it. Specifically, these
gadgets are TIME, DATE, ALARM, SWAP SCREENS, STAY FRONT, and ALARM ON.
TIME allows you to set the system time from within JPClock - simply click in
the string gadget and type the time in (in the format HH:MM:SS). Note that
the last two values are optional, however, to change the second or third
value (minutes or seconds) you must specify the preceding values.
DATE similarly allows you to set the system date, in the format DD-MM-YY
(or MM-DD-YY in -u USA mode). Note please that JPClock is not capable of
handling years past 1999, although it will not crash, the aesthetic balance
of the clock will be disturbed. I have no doubts, however, that by 1999 much
more sophisticated clocks will be available (if not computers) :-).
ALARM allows you to set the Alarm time, ie the time at which the alarm, if
enabled by the ALARM ON gadget, rings. The alarm ring is simply 10
DisplayBeeps (screen flashes).
SWAP SCREENS allows you to shove the clock window to the second screen,
and by clicking again, to shove it back. Note that the window will not move
if there is no second screen, or if the second screen is not big enough
(minimum dimensions are 504x45.)
STAY FRONT, when switched on (highlighted), will keep the JPClock window
at the front of the display at all times. This means that you can never
lose it behind other windows.
ALARM ON, as explained before, allows you to switch the alarm on or off.
The fifteen startup flags allow to to change the way JPClock is configured.
The flag -d allows you to change the delay between updates, and
therefore, the accuracy of the clock. -dSECONDS sets the clock to one update
every SECONDS seconds, where SECONDS is a number from between 1 and 10.
The more time between updates, the less CPU cycles the clock will steal.
The -f flag allows you to automatically set the STAY FRONT option
on; this is identical in effect to turning it on manually by clicking on the
gadget. Similarly, the -a flag allows you to turn the ALARM on. The -u flag
allows you to set USA date mode on; ie dates will be displayed (and expected
to be entered) in the form MM-DD-YY, as opposed to the DD-MM-YY format.
The -o flags allow you to turn various displays in the clock off. -ot turns
the time display off, -oy turns the day display and -od turns the date
display off. -of, -oc and -ol turn fast, chip and total memory display off.
Note that you cannot turn everything off; if everything is turned off, time
is automatically turned back on. The clock window size is changed depending
on how much information is displayed.
The -s flag allows you to automatically shove the clock window to the second
screen; of course, if there is no second screen, or the second screen is too
small, it will not move.
The -at flag, followed by a time in the form HH:MM:SS (or H:MM:SSC if 12 hour
mode is enabled - see below) will set the Alarm time to the time specified.
The -x and -y flags allow you to specify which position the JPClock window
will open in initially; these values default to 70 and 0. -xX and -yY opens
the window with coordinates X,Y.
The -12 flag allows you to specify 12 hour format for the time display. When
-12 is specified, the time will be displayed in the format H:MM:SSC, where
C is a character, either A or P, for AM and PM respectively. Note that when
this option is specified, time and alarm time are expected to be entered
in this format.
Please enjoy JPClock, and do not use it for any evil purposes (huh?..)
In case you feel the urge to correspond with me, my address is
3 William Street
Clarence Park
South Australia, 5034
Australia
and as someone suggested I include it, my 'phone number is 08-293-2788.
Jon.
PS: JPClock is Public Domain, you may do whatever you like with it, however,
if you decide to sell it, at least leave my name in it.
-JP-